Kvwm - Virtual Desktop Manager
Copyright (C) 2005  Jim Stewart


Purpose
-=-=-=-

Kvwm is a Virtual Window Manager, which increases the available work area by creating virtual desktops and allowing the user to switch between them. Kvwm attempts to be simple while at the same time offer a high degree of customization.


Installation
-=-=-=-=-=-=

Simply unzip Kvwm to the location of your choice. The program does not alter your system in any way, nor does it create or alter any registry values.


Usage
-=-=-

Simply run the application to show the pager window. Most settings that are contained within the file settings.ini, and are discussed below. Desktops are represented by the colored squares; click on these with the left mouse button to switch desktops.

The pager window may be moved on the screen by dragging with the left mouse button while holding shift. clicking the right mouse button will cause a menu to show up that will allow the user to gather all visible windows to the current desktop, and to exit the program.


Configuration File
-=-=-=-=-=-=-=-=-=

All configuration settings for Kvwm are held in the file settings.ini. The descriptions of the various settings are as follows, with optional values contained within the brackets. Note that by messing around with these values, a high degree of customization may be achieved.


[Main - Settings]

OnTop=(0,1)			- Boolean Value, specifies whether Kvwm is a topmost window.

TransparencyMode=(0,1,2,3)	- '0' = No transparency effects | '1' = Specified color is blank
				  '2' = Normal transparency     | '3' = Combination of '1' and '2'

TransparencyAmount=(0-255)	- Value that determines transparency level; max is 255

TransparentClr=(#html hex code) - Determines the color to be invisible in mode 1 or 3

PositionStyle=(0-9)		- Determines positioning style. '0' is none, '9' is read from file,
				  the other values form a box of the desktop's corners and sides
                                  as follows:    1    2    3
                                                 4         5
                                                 6    7    8

PositionX=(Number)		- Determines the horizontal position.

PositionY=(Number)		- Determines the vertical position.


[Layout - Settings]

LayoutStyle=(0,1)		- Boolean Value, specifies horizontal or vertical style.

DeskAmount=(Number)		- Number of virtual desktops.

DeskStartup=(Number)		- Desk to start on.

DeskHeight=(Number)		- Height of single pager.

DeskWidth=(Number)		- Width of single pager.

DeskSpacing=(Number)		- Spacing between pagers.


[Border - Settings]

MainBorder=(0,1)		- Boolean value, determines whether main border is shown.

DeskBorder=(0,1)		- Boolean value, determines whether pager borders are shown.


[Graphic - Settings]

MainBackClr=(#html hex code)	- Main background color.
MainForeClr=(#html hex code)	- Main border color.
DeskBackClr=(#html hex code)	- Pager background color.
DeskForeClr=(#html hex code)	- Pager border color.
DeskActiveClr=(#html hex code)	- Color of the active pager.



Note
-=-=-

This application has only been tested on Windows XP, and uses some API functions found only in 2000 / XP. Program may not be compatible with other versions of windows.

Kvwm is released under the GNU General Public License as listed below.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.


Contact
-=-=-=-

Contact me:
methodik@gmail.com
irc.pixelarmy.us/#pixelarmy